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1.0  Scope 

Per  DI-MISC-8()7 1 1,  this  manual  details  the  Data  Logger  Cold  Start  Procedures.  Distribution 
instructions,  interaction  with  other  simulators,  and  hardware  compatibility  notes  (as 
applicable),  build  instructions  as  well  as  a  detailed  overview  of  the  software  release  are 
included  in  the  ADST  Version  Description  Document  for  the  BDS-D  Data  Logger  1.0.0; 
document  number  ADSTAVDL/TR— 93-(K)3073. 


"I  Pete  Peterson  on  this  date  5/14/93,  hereby  certify  that  the  software  release  BDS-D  Data 
Logger  1.0.0  has  been  built  from  limited  access,  controlled  baseline.  This  software  is,  to  the 
best  of  my  knowledge,  free  of  malicious  code  intended  to  subvert  its  operation." 
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2.0  Cold  Start  Methodology 

The  Cold  Start  procedure  for  the  Data  Logger  describes  the  user’s  ability  to  regenerate  a 
Masscomp  560()  operating  system  and  load  the  application  software.  This  procedure 
consists  of  installing  and  bringing  on-line  the  operating  system,  application,  .source  files, 
data  files,  boot  files,  configuration  files  and  databases.  Verification  of  a  build  load  is 
demonstrated  through  a  series  of  tests  or  a  checklist.  This  procedure  also  provides  a 
detailed  list  of  instmctions  that  allow  the  user  to  startup  and  shutdown  the  Data  Logger. 

2.1  Required  Resources 

The  following  sections  outline  the  required  hardware  and  software  resources  needed  to 
install  and  bring  on-line  the  Masscomp  based  Data  Logger. 

2.1.1  Hardware  Resources 

The  Masscomp  ha.sed  Data  Logger  requires  the  following  hardware  configuration  resources 
to  run: 

Hardware  Item  De.scription 

Masscomp  56(M)  Masscomp  5600  computer  mnning  RTU  4.0A  operating  system. 

150  MB  tape  drive  A  150  MegaByie  tape  drive  must  be  installed  in  the  Masscomp  5600 
computer  for  application,  source,  and  operating  system  installations. 


2. 1.2  Software  Resources 

The  magnetic  media  (disks  and  tapes)  prepared  and  supplied  as  part  of  the  BDS-D  Data 
Logger  1.0.0  are  identified  below: 


Media  Type  UM 

DC  6150  Tape  BDS-D  Data  Logger  1.0.0 

DC  6150  Tapxi  BDS-D  Data  Logger  1.0.0 

5  1/4"  Floppy  disk  Boot  Disks 

DC  6150  Tape  RTU4.0A  .system  tape 


2.1.3  Other  Required  Resources 


Description 

Data  Logger  1 .0.0 
application  tape 

Data  Logger  1.0.0  source 
uipe 

Stand  alone  bool  disks  (#1 
&#2) 

RTU4.0A  system  dump 
tape 


There  are  no  other  required  resources. 

2.2  Cold  Start  Procedures 
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The  following  section  outlines  the  procedure  for  performing  a  cold-start  on  the  Masscomp 
5600  system. 

2.2.1  System  Preparation 

This  section  describes  formatting  the  disks  on  the  Masscomp  56(K)  and  installing  the  RTU 
4.0A  operating  system.  These  instructions  demonstrate  how  to  format  the  system  disk, 
install  the  operating  system,  and  perform  system  checks  veritying  that  the  operating  system 
is  running  correctly.  (Warning!!!  -  This  section  should  only  be  performed  by  trained 
system  personnel,  due  to  hardware  differences  between  systems.) 


SYSTEM  PREPARATION 


CONTROL  ACTION 

EXPECTED  RESULTS 

1 .  Log  in  to  Uie  Ma-s-scoinp  as  root 

The  console  tenninal  will  di.splay  the  system 
prompt,  (i.e  SIMLAB13#) 

2.  Reboot  tlie  computer  to  single-u.ser  mtxlc: 

Enter:  reboot  -h  (or)  sync;sync;lialt 

The  con.sole  terminal  will  display  the  single-user 
prompt:  »> 

3.  Insert  stand-alone  floppy  #1  into  floppy  drive. 

None 

4.  Enter:  flp 

The  Ma.sscomp  will  read  from  the  floppy  and,  when 
finished,  the  con.sole  tenninal  will  di.splay  the  $$ 
prompt. 

5.  Insert  suind-alone  floppy  #2  into  floppy  drive. 

None 

6.  To  format  the  internal  htad  disk  drive,  enter: 
/stand/xmeformat  /dev/caO 

The  console  terminal  will  di.splay:  Warning!!!  This 
program  is  about  to  wipe  out  all  contents  of  your 
disk.  Are  you  sure  (ok)? 

7.  Enter:  ok 

The  conjiole  terminal  will  display: 

Choose  one  of  the  following: 

(0)  Custom  Geomeuy  -  manual  entry 

( 1 )  Micropolis  8.*)  mb  (Has  a  rectangular  LEO  ..,) 

(2)  Fuji’  .u  K.S  mb  (Has  a  round  LEI)  on  the  disk...) 

(3)  Micropolis  170  mb  ESDI 

(4)  Micropolis  382  mb  ESDI 

Which  menu  .selection  (0-4)?: 

8.  Enter:  3 

The  con.sole  terminal  will  display: 

Format  the  drive  (yes  or  no)? 

9.  Enter  :  yes 

The  con.sole  tenninal  will  display: 

Do  you  want  to  enter  the  media  defect  list  (yes  or 
no)? 

10.  Enter:  yes 

The  con.sole  tenninal  will  wait  for  your  enuy. 

1 1 .  Install  the  media  defect  floppy  into  Ifie  floppy 
disk  drive,  and  enter  the  ntune  of  the  defect  list  tile 
which  appears  on  the  floppy  label: 
example:  707809,list 

The  console  tenninal  will  display  the  following: 
Cic(»metry  bkH;k  pre.sent  on  di.sk 

U.se  existing  bad  block  list  (yes  or  no)? 
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12.  Enter;  no 

The  me.s.sage  "fonnatting...  '  will  appear  and  die  disk 
drive  I.ICD  will  light  up.  Note:  During  the  format 
operation,  several  fomiat  related  messages  will 
appear.  Error  mes.sages  me  sell-explanatory.  Ilie 
(Inal  mes.sage  to  appear  should  be:  "wrote  bad  sector 
list  for  drive  .serial  #  707809"  and  the  SS  prompt 
will  appetu'. 

13.  Insert  stand-alone  (loppy  #  1  into  (loppy  drive. 

None 

14.  Create  an  empty  file  system;  enter; 

/stand/mkfs  /dev/ca() 

An  empty  file  sy.stem  /dev/caO  is  created,  the  sizes 
arc  di.spliiyed. 

15.  Check  the  tile  system  integrity; 
enter:/stand/f.sck  /dev/caO 

I’ha.ses  0  to  5  of  the  (lie  system  check  me  di.splayed. 

16.  Insert  stand-alone  lloppy  #2  into  lloppy  drive 
and  enter:  /stand/writehnot  /dev/caO 

A  brxit  block  will  be  written  to  the  hard  drive. 

17.  At  the  SS  prompt,  in.sert  the  tape  marked 
"RTU4.0A  system  tape"  into  the  ctirtridge  uipe 
drive  and  enter;  /stand/restr>r 

riie  prompt:  tape?  will  appear  on  the  console 
tenniiud 

18.  Enter  /dev/ctp 

The  prompt:  disk?  will  tippeiir  on  the  console 
terminal 

19.  Enter:  /dev/caO 

riie  prompt;  Ltrst  chiince  before  scribblint!  on  disk. 

20.  Enter  N/L  (note:  upper  case) 

riie  tape  will  stmt  to  move,  files  will  be  restored  to 
the  disk.  When  the  re.store  is  complete,  a  SS  prompt 
will  appear  on  the  console  tennimil. 

21.  Enter:  /.stand/fsck  /dev/caO 

llte  (lie  system  will  be  checked  (phases  0  -  5) 

22.  To  format  die  external  hard  disk  drive,  enter: 
/stand/xmdformat  /dev/daO 

The  console  tenninal  will  display:  Wtuiting!!!  This 
progrmn  is  about  to  wipe  out  all  contents  of  your 
disk.  Are  you  sure  (ok)? 

23.  Enter:  ok 

The  console  lerminal  will  display: 

CIkkksc  one  of  the  following: 

(0)  C'uslom  Geometry  -  manual  entry 

(1)  Fujitsu  Eiigle  (47) 

(2)  Fujitsu  -  80  m2312k  (.34) 

(3)  Fujit.su  -  165  m2322k  (34) 

(4)  CDC  RSD  -  80  (33) 

(5)  Fujit.su  -  337  (68) 

(6)  Fujitsu  -  690  (68) 

Which  menu  selecdon  (0-6)?: 

24.  Enter:  1 

The  comsole  terminal  will  display: 

Fonnat  die  drive  (yes  or  no)? 

25.  Enter  ;  yes 

Ilic  console  tenniiicil  will  display: 

Do  you  want  to  enter  the  media  defect  list  (yes  or 
no)? 

26.  Enter:  yes 

I'hc  comsole  tenniuid  will  wtiit  (or  your  entry. 

27.  Install  the  media  defect  (loppy  into  die  (loppy 
disk  drive,  and  enter  the  name  of  the  defect  list  (lie 
which  appears  on  the  floppy  label: 
example:  707809. list 

The  console  lerminal  will  display  the  following: 

CicomeU'y  blcKk  pre.sent  on  disk 

ll.se  exi.sting  bad  block  list  (yes  or  no)? 

The  console  lerminal  will  display  the  following: 

Cieoinetry  blcKk  present  on  disk 

Use  existing  bad  block  list  (yes  or  no)? 
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28.  Enter:  no 

The  me.s.sage  "fonnatting..."  will  appearand  the  disk 
drive  LED  will  light  up.  Note:  During  tile  format 
operation,  .several  fonnat  related  messages  will 
appear.  Error  messages  are  .self-explanatory.  The 
final  message  to  appeiu  should  be:  "wrote  bad  .sector 
list  for  drive  .serial  #  707809"  and  the  SS  prompt 
will  appeiU'. 

29.  In.sert  stand-tUoiie  lloppy  #  1  into  tloppy  drive. 

None 

29.  Create  an  empty  file  system;  enter: 

/stand/mkfs  /dev/daO 

An  empty  file  system  /dev/caO  is  created,  the  sizes 
are  di.splayed. 

30.  Check  the  file  .system  integrity; 
enier:/stand/fsck  /dev/daO 

Phases  0  to  .S  of  the  file  system  cheek  aie  di.splayed. 

31.  Enter;  con.sole 

The  coirsolc  prompt  »>  will  appear  on  tlie  con.sole 
terminal. 

32.  Enter;  b  cad/unix 

The  .system  will  boot  up  into  multi-u.ser  mode,  the 
prompt  "  To  use  cuirent  time,  enti'.r  RE'llJlW  will 
appciir. 

33.  Enter  the  current  date  and  time  in  the  following 
fonnat;  07-Apr-93  16:00 

The  console  tenninal  will  display  messages,  the 
prompt  system  prompt  (i.e  SIMLAB13  #)  will 
appear,  then  the  multi-user  login  prompt  (login;) 
will  appear. 

34.  Enter;  root 

The  prompt  TERM  =  (vtlOO)  will  appear. 

3.‘i.  Enter  a  carriage  return 

Ilie  .screen  will  clear,  date  and  lime  will  appetu,  then 
the  .system  prompt  (i.e.  S1MLAB13  #). 

36.  Remove  floppy  tuid  tape  and  proceed  to 
installation  of  release. 

None 
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2.2.2  Installation  of  Release 

This  section  describes  the  installation  of  the  BDS-D  Data  Logger  1.0.0  relea.sc  tape  on  to 
the  Masscomp  56(K)  computer  system.  A  list  of  executable  files,  data  files,  configuration 
files,  startup  and  shutdown  files  and  their  respective  location  in  the  directoi7  tree  is  shown 
in  Table  2-1.  Table  2-1  allows  the  user  to  verify  that  what  was  copied  off  the  BDS-D  Data 
Logger  1.0.0  release  tape  on  to  the  target  machine  to  run  in  an  operational  environment  is  a 
complete  list  of  application  files  and  their  location  in  the  directoiy  tree. 

INSTALLATION 


1.  Load  the  insuillaiion  uipe  into  the  tape  drive. 

None 

2.  Log  on  to  the  Ma.s.scotnp  5600  as  root. 

The  console  terminal  will  display  the  system 
prompt:  (i.e.  SIMLAB  13  #) 

3.  Set  to  the  correct  default  directory 
cd  /direct»»rv_name 

The  console  terminal  will  display  the  system 
prompt:  (i.e.  SIMLAB  13  #) 

4.  Read  in  die  installation  tape.  Enter: 
tar  xvf  /dev/retp 

The  Uipe  will  move.  Hletuunes  will  scroll  by  on  die 
con.sole  terminal. 

5.  When  the  tape  is  fully  rewound  tmd  the 

SIMLAB 1 3  #  prompt  appetas,  remove  the 
in.stallation  tape. 

None 

Table  2-1 


/logger_  1.0.0 

•simnet/bin/logger 

simnet/bin/enp.bin 

simnet/data/loghelp 

*  simneiydaia/neiwork.def 

*  simnet/data/a.ssoc.def 

*  simnei/data/logdev 

*  These  files  are  site/liost  specific  and  are  not 


Description 


Data  Logger  Executable. 

Binai7  downloaded  and  executed  on 
the  CMC  Ethernet  cai'd.  Includes 
Logger  specific  filtering. 

ASCII  text  file  containing  help  for  the 
Logger's  on-line  help  facility. 

ASCII  text  file  containing  data  that 
defines  the  configuration  of  the 
SIMNET  network  inlerface. 
Simulation  network  configuration  file 
defining  the  site/host  tuple  for  all 
simulation  hosts  participating  in  an 
exercise. 

Specifies  mapping  between  logical 
recording  devices,  such  as  disk  or  8- 
track  tape,  and  physical  device 
names,  such  as  /dev/retp. 

included  in  the  relea.se  tape. 
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2.3  Warm  Start  and  Shutdown  Procedures 

The  following  section  outlines  the  procedure  for  performing  a  wann-starl  and  shutdown  of 
the  Masscomp  56(K)  system. 


2.3.1  Startup  Procedures 

This  section  describes  in  detail  how  to  startup  the  Data  Logger. 


STARTUP  PROCEDURES 


CONTROL  ACTION 

EXPECTED  RESULTS 

1 .  LcKale  the  DaUi  Logger  juid  the  Ma.s.scoiTip  .'^600 
computer  that  die  iii.stidlation  will  be  perlorined  on. 

None 

2.  Power  up  die  Mas.scomp  5600  by  turning  the 
key.'iwitch  (located  on  the  Iront  panel)  to  the  T' 
position. 

'I'hc  con.solc  lerininal  will  display:  login: 

.V  Log  in  as  mot 

The  console  terminal  will  display  a  system 
prompt.(i.e.  SIMLABl.^  #) 

4.  Change  to  the  binary  execuuible  directory. 

Enter;  cd  /.simnet/bin 

The  con.sole  terminal  will  display  a  system 
prompt.(i.e.  SIMLAB13  #) 

5.  Start  up  the  network  and  CiG  communictitions: 
Enter:  netstart 

The  console  terniinid  will  display: 

Killing  running  ringstari... 

Resetting  /dev/enpO... 

Loading  /simnei/bin/enp.bin  on  /dev/enpO... 

Starting  /simnei/bin/ringstiut.. 

11182 

Done 

SIMLABL3  # 

6.  Start  up  the  data  logger. 

Enter.  Ioga«r  -  (option) 

A  list  of  options  will  appettr  as  listed  in  Table  2-2. 
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Table  2.2 

IMasscomp  Data  Lopger  Command  Line  Switches  and  Parameters 

Usage;  logger  switches  ... 

Mu.sl  .specify  one  of  the  following  Hags; 

-  c  (opy  or  convert  data  files) 

-  p  (lay  tape  of  net  traffic) 

-  r  (ecord  net  traffic) 

-  h  (elp) 

-  s  (erver  mode  -  control  from  PVD) 

-  V  (ersion  information) 
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2.3.2  Shutdown  Procedure 

The  following  wrillen  set  of  procedures  describe  in  detail  how  to  shutdown  the  Data 
Logger. 


SHUTDOWN  PROCEDURES 


CONTROL  ACTION 

EXPECTED  RESULTS 

1.  On  console  icnnitial.  quit  the  siinuliiiion  it 
running,  linicr:  (| 

Simulation  should  exit,  ('onsolc  tenninal  will 
di.splay  .system  prompt  (i.e.:  SIMI.ABl.^  #) 

2.  At  tlic  SIMI.ABl'!  #  prompt,  cntcrisliutdown 
(or) 

At  the  SIMLABl.^  #  prompt,  enter:  sync 

sync 

halt 

The  messtige:  syncing  disks...  will  appear,  then  the 
prompt  »>  will  be  displayed. 

Turn  die  I'roni  panel  key  switch  to  die  "0" 
position. 

The  system  will  power  oH. 
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3.0  Release  Validations 

3.1  Cold  Start  Validation 

The  following  writien  sei  of  procedures  instructs  the  user  on  how  to  validate  the  success  ol' 
the  cold-start. 

Cold-start  Validation  Instructions; 

The  expected  results  detailed  in  the  System  Preparation  and  Release  Installation  Procedure 
sections  are  indicative  of  a  successful  cold-stail. 

3.2  Warm  Start  Validation 

The  following  written  set  of  procedures  instructs  the  user  on  how  to  validate  the  load  once  it  is 
operational. 

Warm  Start  Validation  Instructions; 

The  expected  results  detailed  in  the  Startup  Procedure  section  are  indicative  of  a  successful  warm 
start.  After  completion  of  Startup  Procedure  step  6,  the  Data  Logger  may  be  activated. 
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